Previous topicNext topic
 Gameofmir Help
Help > 游戏引擎功能系统 > 游戏功能详解 >
NPC脚本使用图标功能

NPC脚本使用图标功能[!] - 客户使用说明

NEW NPC 对话框图片标签现在支持图片文字标题和图片备注。<IMG:>、<IMGEX:>、<PLAYIMG:> 均可在图片上叠加文字标题，也可使用普通悬停备注或 ItemShow#物品IDX#模式。旧脚本写法完全兼容。
目录

一、快速写法

用途写法
显示静态图片<IMG:N:F:X:Y>
显示三态按钮图片<IMGEX:F:U:H:D:X:Y>
播放动态图片<PLAYIMG:F:N:C:T:X:Y:M:L>
图片上叠加文字标题<IMG:N:F:X:Y:按钮,10,10,250#>
点击图片触发脚本<IMG:N:F:X:Y/@Label>
鼠标悬停显示文字备注<IMG:N:F:X:Y|备注内容>
鼠标悬停显示物品属性<IMG:N:F:X:Y|ItemShow#物品IDX#模式>
备注和点击同时使用<IMG:N:F:X:Y|ItemShow#物品IDX#模式/@Label>

标签大小写不敏感，IMG、Img、img 都可以使用。以下说明统一使用大写写法。

二、<IMG:> 静态图片

格式

<IMG:N:F:X:Y:文字标题/@Label>
参数说明
N图片索引，也就是 WIL 文件中的第几张图片。
FWIL 文件序号。可在引擎 查看 → 列表信息(二) → WIL资源 中查看。
X横向坐标微调，单位像素。可省略，默认 0。
Y纵向坐标微调，单位像素。可省略，默认 0。
文字标题第 5 参数。格式为 标题名称,X,Y,文字颜色#，可省略。
@Label点击图片时触发的 NPC 脚本标签。可省略。

示例

;显示 WIL 0 号文件第 10 张图片
[@main]
显示图标<IMG:10>

;指定 WIL 文件序号，并微调图片位置
[@main]
显示图标<IMG:1185:1:1:-10>

三、<IMGEX:> 三态按钮图片

格式

<IMGEX:F:U:H:D:X:Y:E:文字标题/@Label>
参数说明
FWIL 文件序号。
U默认显示的图片索引。
H鼠标放上去时显示的图片索引。
D鼠标点下去时显示的图片索引。
X横向坐标微调，单位像素。
Y纵向坐标微调，单位像素。
E第 7 参数，保留给原来的输入框检查参数。没有使用时可留空。
文字标题第 8 参数。格式为 标题名称,X,Y,文字颜色#，可省略。
@Label点击图片时触发的 NPC 脚本标签。可省略。

示例

;按钮三态：默认 1600，移入 1601，按下 1602
[@main]
打开功能<IMGEX:0:1600:1601:1602:0:0/@打开功能>

[@打开功能]
测试通过

四、<PLAYIMG:> 动态图片

格式

<PLAYIMG:F:N:C:T:X:Y:M:L:文字标题/@Label>
参数说明
FWIL 文件序号。
N播放开始图片索引。
C播放张数，也就是动画帧数。
T播放速度，单位毫秒。数值越小播放越快，常用 60 到 150。
X横向坐标微调，单位像素。
Y纵向坐标微调，单位像素。
M绘制模式：0=普通绘制，1=特效绘制。
L播放次数。为空或 0 表示无限循环；大于 0 时，播放指定次数后自动消失。
文字标题第 9 参数。格式为 标题名称,X,Y,文字颜色#，可省略。
@Label点击动态图片时触发的 NPC 脚本标签。可省略。

示例

;播放 WIL 1 号文件，从 610 开始播放 19 张，每帧 100 毫秒
[@main]
播放图片<PLAYIMG:1:610:19:100/@播放图片>\

[@播放图片]
测试通过

;带坐标微调的动态图片
[@main]
播放图片<PLAYIMG:1:130:7:300:-100:-100>\

五、点击图片触发脚本

在图片标签最后加 /@Label，玩家点击图片时会触发对应的 NPC 脚本标签。

[@main]
显示图标<IMG:1185:1:1:-10/@Hint>

[@Hint]
测试通过

如果图片同时需要备注，推荐先写备注，再写点击标签：

[@main]
显示图标<IMG:1185:1:1:-10|这是图片备注/@Hint>

[@Hint]
测试通过

六、图片文字标题

图片文字标题是直接画在图片上的文字，不是鼠标悬停备注。标题参数格式固定为：

标题名称,X,Y,文字颜色#
参数说明
标题名称显示在图片上的文字，例如 按钮、领取、兑换。
X文字相对图片左上角的横向偏移，单位像素。
Y文字相对图片左上角的纵向偏移，单位像素。
文字颜色颜色索引，例如 250 浅蓝、254 黄色、255 白色。也可使用 $BBGGRR 或 #RRGGBB。
#标题参数结束标记，必须写在颜色后面。
标题参数最后必须带 #。未带 # 时，客户端会按旧的输入框检查参数处理，避免影响旧脚本。

IMG 第 5 参数标题

[@main]
;在静态图片上显示“按钮”，文字坐标 10,10，颜色 250
<IMG:1600:0:0:0:按钮,10,10,250#>

IMGEX 第 8 参数标题

[@main]
;第 7 参数没有使用时留空，第 8 参数写标题
<IMGEX:0:1600:1601:1602:0:0::按钮,10,10,250#>

;如果第 7 参数要写输入框检查参数，第 8 参数继续写标题
<IMGEX:0:1600:1601:1602:0:0:1,2:按钮,10,10,250#>

PLAYIMG 第 9 参数标题

[@main]
;动态图片上显示“按钮”，文字坐标 10,10，颜色 250
<PLAYIMG:0:1610:10:100:0:0:0:0:按钮,10,10,250#>

标题、备注、点击同时使用

[@main]
<IMG:1600:0:0:0:按钮,10,10,250#|ItemShow#13#0/@测试>

[@测试]
测试通过

七、图片备注与 ItemShow

1. 普通文字备注

IMG、IMGEX、PLAYIMG 都支持在图片标签内使用 |备注内容。鼠标放到图片上时，会显示备注窗口。

[@main]
普通图片备注<IMG:1600:0:0:0|这是静态图片备注>
按钮图片备注<IMGEX:0:1600:1601:1602:0:0|这是按钮图片备注>
动态图片备注<PLAYIMG:0:1610:10:100:0:0:0:0|这是动态图片备注>

备注内容需要换行时，可使用 ^。需要使用颜色格式时，可按客户端彩色提示格式填写，# 会自动转换为 /。

[@main]
彩色备注<IMG:1600:0:0:0|254#标题^250#说明内容>

2. ItemShow 物品属性备注

图片备注支持 ItemShow#物品IDX#模式。鼠标放到图片上时，不显示普通文字备注，而是显示指定物品的属性窗口。

<IMG:N:F:X:Y|ItemShow#物品IDX#模式>
<IMGEX:F:U:H:D:X:Y|ItemShow#物品IDX#模式>
<PLAYIMG:F:N:C:T:X:Y:M:L|ItemShow#物品IDX#模式>
参数说明
物品IDX物品数据库中的 IDX。客户端需要能读取到该物品数据。
模式与原 <Text:...|ItemShow#IDX#模式> 的第三参数一致。一般填 0；需要特殊显示模式时填 1。

3. ItemShow 示例

[@main]
;鼠标放到静态图片上，显示 IDX=13 的物品属性
静态图片物品备注<IMG:1600:0:0:0|ItemShow#13#0>

;鼠标放到三态按钮图片上，显示 IDX=13 的物品属性
按钮图片物品备注<IMGEX:0:1600:1601:1602:0:0|ItemShow#13#0>

;鼠标放到动态图片上，显示 IDX=13 的物品属性
动态图片物品备注<PLAYIMG:0:1610:10:100:0:0:0:0|ItemShow#13#0>

;图片既能显示物品属性，也能点击触发脚本
可点击物品图片<IMG:1600:0:0:0|ItemShow#13#0/@测试>

[@测试]
测试通过

八、完整示例

;显示图标
[@main]
显示图标<IMG:10>

;设置坐标显示更加精确
[@main]
显示图标<IMG:1185:1:1:-10>

;可执行脚本的图片
[@main]
显示图标<IMG:1185:1:1:-10/@Hint>

[@Hint]
测试通过

;通过空格控制图片显示的位置
;注意前面的空格，以及和 X / Y 坐标的区别
[@main]
    <IMG:1185:1:1:-10>显示图标

;播放动态图片
[@main]
播放图片<PLAYIMG:1:610:19:100/@播放图片>\
播放图片<PLAYIMG:1:130:7:300:-100:-100>\

;图片文字标题
[@main]
静态标题<IMG:1600:0:0:0:按钮,10,10,250#>\
按钮标题<IMGEX:0:1600:1601:1602:0:0::按钮,10,10,250#>\
动态标题<PLAYIMG:0:1610:10:100:0:0:0:0:按钮,10,10,250#>\

[@播放图片]
动态图片点击通过

九、注意事项

项目说明
WIL 文件序号必须是客户端已经加载的图片资源序号。文件不存在或序号超界时，图片不会显示。
图片索引图片索引从资源文件内的实际图片编号读取，请以 WIL 查看工具或引擎列表为准。
X / Y 微调用于微调这一张图片的绘制位置，不等同于脚本文字前面的空格。
图片文字标题格式为 标题名称,X,Y,文字颜色#。标题坐标相对图片左上角，不改变图片本身位置。
点击标签@Label 是触发标签名，脚本段落仍然写成 [@Label]。
备注和点击同时使用时写成 |备注/@Label，先写备注，再写点击标签。
ItemShow图片上的 ItemShow#IDX#模式 与文字 Text 的 ItemShow 用法保持一致，适合在活动按钮、奖励图标、动态图标上展示物品属性。
普通 NPC 对话图标说明只适用于 NPC 脚本对话框。小地图、MapDesc、装备备注等图文混排格式请查看对应的专用说明文档。